Migrate Eggplant DAI to Another Server

You can migrate a working version of a Windows, on-prem, Eggplant DAI Server installation from one Windows system to another. Keysight provides a script you can use to help you perform this type of migration along with instructions for using it, which are provided below.

Important

Starting in version 25.3, the Windows DAI Server stores passwords in the Windows operating system Credentials Manager. To migrate DAI Server versions 25.3 and later to different Windows systems, Keysight provides a script you can use to perform the migration, including the data from the Windows Credentials Manager.

The script that includes the code to migrate data from the Credentials Manager is not included with DAI 25.3. It is an amended version of the dai_secrets.py script, which is installed with 25.3 but doesn't include the code to migrate data from the Credentials Manager. To request the amended version of the script, contact Keysight Eggplant Customer Support.

Information about where to replace the script in the DAI installation is provided in the instructions below.

For information about migrating servers from versions prior to 25.3, please see the "Migrate Eggplant DAI to Another Server" page in the documentation for the DAI version you want to migrate.

Migrating a DAI Server to Another System

These instructions are for Windows, on-prem DAI Server version 25.3, specifically. For information about other versions, please see the documentation for the version you want.

1. Request the amended dai_secrets.py script from Keysight Eggplant Customer Support. A version of this file is included in the 25.3 installation but it does not include the code to migrate data from the Windows Credential Manager.

2. On the system that DAI will be migrated to (the destination system), perform a clean installation of DAI 25.3. Then confirm that the DAI home page loads successfully and that you can log in to DAI.

3. On the system where the DAI Server you want to migrate is running (the source system), do the following:

   • Stop the DAI Server Windows service.
   • Go to C:\ProgramData\Eggplant\Digital Automation Intelligence directory.
   • Copy the data and minio folders, and the config.yml file, and then transfer them to the destination system.
   • Start the DAI Server service again.

4. On the destination system, do the following:

   • Stop the DAI Server Windows service and go to C:\ProgramData\Eggplant\Digital Automation Intelligence.
   • Replace the existing data and minio folders, and the config.yml file with the copies from the source system.
   • Delete the rabbitmq folder.

5. On both the destination and source systems, download the amended dai_secrets.py script you received from Customer Support.

6. On the source system, do the following:

   • Go to folder C:\Program Files\Digital Automation Intelligence\python\tools\Lib\site-packages\eggplant\win_dai_service and backup the dai_secrets.py script file.
   • Replace it with the file downloaded in the previous step.

7. On the destination system, do the same as above.

8. On the source system, do the following:

   • Open a command prompt window with "Run as Administrator" and run the following command:

     "C:\Program Files\Digital Automation Intelligence\python\tools\python.exe" "C:\Program Files\Digital Automation Intelligence\python\tools\Lib\site-packages\eggplant\win_dai_service\dai_secrets.py" read C:\<path_to_file>\dai_source_secrets.txt

     Where the <path_to_file> is the location on the C: drive where DAI will create the dai_source_secrets.txt file. (You can use a different file name instead if you want).

     The command reads the DAI secrets from the Windows Credentials Manager and writes them in the dai_source_secrets.txt file.

   • Copy the dai_source_secrets.txt file to the destination machine and run the following command:

     "C:\Program Files\Digital Automation Intelligence\python\tools\python.exe" "C:\Program Files\Digital Automation Intelligence\python\tools\Lib\site-packages\eggplant\win_dai_service\dai_secrets.py" write C:\<path_to_file>\dai_source_secrets.txt

     This command will take the secrets from dai_source_secrets.txt and write them in the Windows Credentials Manager on the destination machine.

9. On the destination system, do the following:

   • Start the DAI Server service on the destination machine.
   • Open http://localhost:4652/auth in a browser and log in using the DAI System administrator credentials from the source machine.
   • Go to Manage Realms and click Eggplant to change the realm to Eggplant.
   • In menu Clients, search for web and click client:dai:user_agent:web.
   • In Settings → Valid Redirect URIs, change the hostname to the hostname of the destination machine, and click Save.

Deleting Secrets from the Original DAI Server Host System

If you need to delete the DAI secrets from the Windows Credentials Manager on the original DAI host system (called the source system in the instructions above) use the following command:

"C:\Program Files\Digital Automation Intelligence\python\tools\python.exe" "C:\Program Files\Digital Automation Intelligence\python\tools\Lib\site-packages\eggplant\win_dai_service\dai_secrets.py" delete